<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>figure</title>
  </head>
  <body bgcolor="#FFFFFF">
    <center>Scilab Function</center>
    <div align="right">Last update :  04 June 1998</div>
    <p>
      <b>figure</b> -  create a figure</p>
    <h3>
      <font color="blue">Parameters</font>
    </h3>
    <ul>
      <li>
        <tt>
          <b>o</b>
        </tt>h : integer Handle of the window to create. If not specified, the first free handle is used</li>
      <li>
        <tt>
          <b>o</b>
        </tt>prop{1, 2 ...} : character string name of a property to set</li>
      <li>
        <tt>
          <b>o</b>
        </tt>val{1, 2 ...} : scilab object value to give to the corresponding property</li>
      <li>
        <tt>
          <b>o</b>
        </tt>hn : handle of the newly created window</li>
    </ul>
    <h3>
      <font color="blue">Description</font>
    </h3>
    <p>
    This routine creates a tksci figure (toplevel window). If a handle is
    given, the figure corresponding to this handle is created .
    Otherwise, the window is created with the first free handle, that is
    the lowest integer not already used by a window.  The property named
    'position' allows to control the geometrical aspect of the control.
    It is a [ 1,4] real vector x y w h where the letters stand for the x
    location of the left bottom corner, the y location of the left bottom
    corner, the width and the height of the uicontrol.
     
    One can also set this property by giving a string where the fields are
    separated by a '|', ie "x|y|w|h".</p>
    <h3>
      <font color="blue">Examples</font>
    </h3>
    <pre>

h=figure(3);
// creates  figure number 1.
uicontrol( h, 'style','text', ...
 'string','This is a figure', ...
 'position',[50 70 100 100], ...
 'fontsize',15);
// put a  text in figure 3
figure();
// create figure 1
uicontrol( 'style','text', ...
 'string','Another figure', ...
 'position',[50 70 100 100], ...
 'fontsize',15);
// put a text in figure 1
close();
// close the current graphic window (ie fig. 1)
close(h);
// close figure 3
 
  </pre>
    <h3>
      <font color="blue">See Also</font>
    </h3>
    <p>
      <a href="close.htm">
        <tt>
          <b>close</b>
        </tt>
      </a>,&nbsp;&nbsp;<a href="../graphics/gcf.htm">
        <tt>
          <b>gcf</b>
        </tt>
      </a>,&nbsp;&nbsp;</p>
    <h3>
      <font color="blue">Author</font>
    </h3>
    <p>Bertrand Guiheneuf</p>
  </body>
</html>
